(parameters that affect read, write, and copy transfers)
PPPPMMMM____SSSSHHHHIIIIFFFFTTTT, default value: 0. Number of bit positions that pixel
data are to be shifted. Positive shifts are left for write and
copy, right for read. Valid values: 0, +-1, +-4, +-8, +-12, +-
16, +-24
PPPPMMMM____EEEEXXXXPPPPAAAANNNNDDDD, default value: 0. Enable (1) or disable (0) expansion
of single-bit pixel data to one of two 32-bit pixel values.
Valid values: 0, 1
PPPPMMMM____CCCC0000, default value: 0. Expansion value (32-bit packed color)
chosen when the single-bit pixel being expanded is zero. Valid
values: any 32-bit value
PPPPMMMM____CCCC1111, default value: 0. Expansion value (32-bit packed color)
chosen when the single-bit pixel being expanded is one. Valid
values: any 32-bit value
PPPPMMMM____AAAADDDDDDDD22224444, default value: 0. Amount to be added to the least-
significant 24 bits of the pixel (signed value). Valid values: a
32-bit signed value in the range -0x800000 through 0x7fffff
Although this value is specified as a 32-bit integer, the sign
bit MUST be smeared across all 32 bits. Thus -0x800000 specifies
the minimum value; and 0x800000 is out of range at the positive
end.
PPPPMMMM____TTTTTTTTOOOOBBBB, default value: 0. Specifies that fill (for write and
copy transfers) and read (for read transfers) must be top-to-
bottom (1) or bottom-to-top (0). Valid values: 0, 1 (see NOTES
below)
PPPPMMMM____RRRRTTTTOOOOLLLL, default value: 0. Specifies that fill (for write and
copy transfers) and read (for read transfers) is to be right-to-
left (1) or left-to-right (0). Valid values: 0, 1
PPPPMMMM____IIIINNNNPPPPUUUUTTTT____FFFFOOOORRRRMMMMAAAATTTT,,,, PPPPMMMM____OOOOUUUUTTTTPPPPUUUUTTTT____FFFFOOOORRRRMMMMAAAATTTT, default values: PM_ABGR. If in
RGBmode, specifies the pixel color component format; if in cmode,
has no effect. The format specifies the number and order of color
components. May be one of: PM_ABGR, PM_BGR, PM_RGBA, PM_RGB,
PM_LUMINANCE, PM_LUMINANCEA, PM_ALPHA. If PM_LUMINANCE or
(parameters that affect read and write transfers only)
PPPPMMMM____SSSSIIIIZZZZEEEE, default value: 32. Number of bits per pixel. Used for
packing during reads and writes. Valid values: 1, 4, 8, 12, 16,
24, 32, 64 (see NOTES below)
Although size specification is for the entire pixel, there is no
mechanism for specifying reduced RGBA component sizes (such as
12-bit RGB with 4 bits per component) except as in NOTES below.
PPPPMMMM____OOOOFFFFFFFFSSSSEEEETTTT, default value: 0. Number of bits of the first CPU
word of each scanline that are to be ignored. Valid values: 0
through 31
PPPPMMMM____SSSSTTTTRRRRIIIIDDDDEEEE, default value: 0. Number of 32-bit CPU words per
scanline in the original image (not just the portion that is
being transferred by this command). Valid values: any non-
negative integer
(parameters that affect write and copy transfers only)
PPPPMMMM____ZZZZDDDDAAAATTTTAAAA, default value: 0. Indicates (1) that pixel data are to
be treated as Z data rather than color data (0). Destination is
the Z-buffer. Writes are conditional if zbuffering is on. Valid
values: 0, 1
_v_a_l_u_e Integer value assigned to mode.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
ppppiiiixxxxmmmmooooddddeeee allows a variety of pixel transfer options to be selected. These
options are available only for pixel transfer commands that operate on
32-bit data: llllrrrreeeeccccttttrrrreeeeaaaadddd, llllrrrreeeeccccttttwwwwrrrriiiitttteeee, and rrrreeeeccccttttccccooooppppyyyy. Pixel transfer commands
that operate on 8-bit data (rrrreeeeaaaaddddRRRRGGGGBBBB, wwwwrrrriiiitttteeeeRRRRGGGGBBBB) and on 16-bit data
(rrrreeeeaaaaddddppppiiiixxxxeeeellllssss, wwwwrrrriiiitttteeeeppppiiiixxxxeeeellllssss, rrrreeeeccccttttrrrreeeeaaaadddd, rrrreeeeccccttttwwwwrrrriiiitttteeee) do not support ppppiiiixxxxmmmmooooddddeeee
capabilities. Note that llllrrrreeeeccccttttrrrreeeeaaaadddd, llllrrrreeeeccccttttwwwwrrrriiiitttteeee, and rrrreeeeccccttttccccooooppppyyyy are valid in
systems, you get better pixel fill rate (both write and read) if you
specify PPPPMMMM____TTTTTTTTOOOOBBBB (top-to-bottom) as the direction of fill.
For writing interlaced fields of video data to the frame buffer, Indy and
XL systems write every other scan line, bottom-to-top, when PPPPMMMM____TTTTTTTTOOOOBBBB is 2,
and every other scan line, top-to-bottom, when PPPPMMMM____TTTTTTTTOOOOBBBB is 3.
Indy and XL systems support a 3-3-2 pixel format in a byte (rightmost
three bits red, next three bits green, and next two bits blue) for
PPPPMMMM____SSSSIIIIZZZZEEEE of 9. Indigo Entry systems support a 3-3-2 pixel format in a
byte (rightmost three bits red, next two bits blue, and next three bits
green) for PPPPMMMM____SSSSIIIIZZZZEEEE of 8.
PPPPMMMM____SSSSIIIIZZZZEEEE,,,,66664444 is implemented on RealityEngine models only. Each 64-bit
pixel contains four 16-bit color components for red (rightmost), green,
blue, and alpha (leftmost). Only the upper 12 bits of each component are
significant. The lower 4 bits are returned as zero.
PPPPMMMM____OOOOUUUUTTTTPPPPUUUUTTTT____FFFFOOOORRRRMMMMAAAATTTT,,,, PPPPMMMM____OOOOUUUUTTTTPPPPUUUUTTTT____TTTTYYYYPPPPEEEE,,,, PPPPMMMM____IIIINNNNPPPPUUUUTTTT____FFFFOOOORRRRMMMMAAAATTTT,,,, PPPPMMMM____IIIINNNNPPPPUUUUTTTT____TTTTYYYYPPPPEEEE are
implemented on RealityEngine models only.
BBBBUUUUGGGGSSSS
On the Personal Iris, when using PPPPMMMM____SSSSIIIIZZZZEEEE with values 8 or 16, the width
of the rectangle drawn must be a multiple of 4 for 8-bit packed writes,
and a multiple of 2 for 16-bit packed writes.
On the IRIS-4D RealityEngine model PPPPMMMM____SSSSIIIIZZZZEEEE of 24 is not supported in
color map mode. PPPPMMMM____SSSSIIIIZZZZEEEE of 32 in conjunction with a non zero PPPPMMMM____OOOOFFFFFFFFSSSSEEEETTTT is
